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8K-EDITOR 


DECUS frogram Library Write-up 


DECUS NO. 8-397 


NOTE: I wish to thank Roger Collins, without whose complaints, an editor of this 
calibre would not have been possible. 


PART ONE - Input/Output Specifications 
I. Disk Systems 

A. My editor uses the "command decoder" to set up I/O. This must be set as internal 
block ^5 in the SAM directory. This "Command Decoder" is set up by version AF of the. 
disk monitor system. 


B. The possible file types are: 


T: 

R: 

S: filename 
^ (carriage return) 


Low Speed paper 
H/S paper tape 
disk dataset 
null device 


NOTE: These may be mixed in any order for the input and output prompts. I/O filenames 
may be the same. 


A typical ".CD. " - user "conversation" might be: (underlined portions are typed by the 
machine) 


^ Edit ^ 

♦OUT - S:BILL ^ 
* 

♦IN - S:BILL 0- 
* 

♦OPT - a. 

E=> 


Output to disk (BILL) 
Input from disk (BILL) 
None specified 
Editor Command Level 


Notice that disk l/O files may be the same. Only one file may be specified for each 
l/O prompt. 


The option prompt ignores all but a answer. A "D" answer specifies deletion of the input 
file from disk after it has been read. An output file will not be cleared until output from the 
editor is attempted. 

NOTE - The high speed (H/S) reader and punch are always enabled. 












II. Non-disk Systems 

A. Non-disk Systems must have a iVS paper tape system. The starting address is at 01000 


I 


rather than 03^^^ as in the disk system. 

B. All I/O commands use the H/S equipment. This system will act in exactly the same way 
as if the disk system user had specified the following initialization: 

*OUT - R: O' 

* 

*IN- R: Q. 

* 

*OPT - 


CAUTION: If an "E" command is given, control will be returned to location 7600^ “ field 
as if a normal return to the disk monitor were expected. ° 

PART TWO - Commands and Formats 

I. Generalized Command Format 
The generalized format is: 

E=>^ k ^nnn^mmni^jString^ J ^bstring^^O^ 

©(E)© 0© © © ® '©' 

where: 

© is Command Level Prompt from Editor 
@ The one letter command 

"nnn" Is a line or column ^ (optional) 

@ ",mmm" is a second line ^ (optional) 

@ is the search string delimiter (originally set to $") (optional) 

©“© are search strings of one or more characters separated by a delimiter 
(1) is a return (carriage return char.) 

Parts (^ thru (T) are optional depending on the command. 

II. Special Characters 

1). control-L (214g) deletes the entire command and returns to the editor command level. 
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2) . rubout - (377g) erases the immediately preceding character which is not itself a 
rubout. If the command character is erased, a return to command level will follow. 

3) . Space (24j^g) are ignored except in search strings. 


4) . Slash ("/*') •’he last line ^ is used in its place (except in search strings). 

5) . Dot or period (". ") same as slash only use current line ^ . 

6) . plus, minus, used to add or subtract line ^'s. ” 1-3 *' or ”.+l " 

III. Command List 

EXPLANATION 


append 
bottom 
change 
delete 
end 

fix the tab 
get 

H/S read 
insert 
list 
next 
output 
. H/S punch 
quit 
read 
search 
top 

unset verification 
set verification 
unset line ^'s 
next line 
previous line 
print current line ^ 
print last line ^ 
set line ^'s 
change base 
print current base 
change the delimiter 
repeat the previous command 

PART THREE - Commands and Explanations 

Command 


COMMAND 

A 

B 

C 

D 

E 

F 

G 

H 

I 

L 

N 

O 

P 

Q 

R 

S 

T 

U 

V 

X 

> 

< 


/ 

§ 


A) append 
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Form: 


E=> A ^ 


Append to the end of the current buffer. Input format the same as on the "l''nsert command. 
Executes the same as E=> I/+1 4* 

bottom 

Form: B 

Print last line and set current line pointer to last line. 

Form: B n<i String ^ 

Find the last occurrence of "String" in the buffer and print that line. If "n" is omitted 
assume 1 and start search with that line 


change 


Form: C n,m ^ 

Executes the same as : 

E=> Dn,m 4- 
E=> In ^ 

(5) Form: C n,m fstring ^gstring X 

Change "fstring" to "gstring" in lines 'Vjjl thru "m" . Only the first occurrence on each line 
is changed. If "n,m" is omitted, "." is assumed. 

delete 


Form: Dn,m 

delete lines "n" thru "m" from the current buffer. 


end 

Form: E ^ 

Perform "Nexts" until no input'is left and then close the output file. A return to the 
DISK MONITOR (76J0S0g) follows. 

(See notes on Control-C at end of tutorial) 

fix the logical tab 

Form: F n ^ 






Set the tab at "n" columns and each multiple of "n" following it. A control-1 (tab) is 
echoed as the appropriate ^ of spaces. 
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(§) 9 ®^ 

Form: G n 

Get and print the next line which begins with a character other than tab (control-1, 21 Ip) 
or space (240g). Start search with line "n". If "n" is omitted assume ".+1 

@ Form: G n ^ String ^ 

Starting with line "n", find the first line which contains "String" in the |firstl ''tab”* 
columns. If "n" Is omitted, ".+1 " is assumed 

* (Logical tab is initially set at 8 columns.) 

high speed paper tape READ 

Form: H 

Same as READ command, except always use H/S reader. 



Form: I n 

Insert, before line "n", as many lines as are entered from the keyboard. Each line is 
terminated by a " ^ ", line-feeds are ignored. Insert mode is prompted by "nrin>"; where 
"nnn" is the line to be entered. NOTE - If the "X" command has been used, ">" will be 
the only prompt. Rubouts may be used to erase incorrect characters on the current line. 
Insert mode is exited by a control-L (214_) character; the current liiie (before a control-L) 
is ignored. If "n" is omitted, "1 " is assumed. 

© 

Form: L n,m ^ 

List lines "n" thru "m", inclusive. If "m" is omitted, list "n" only. If "n" is omitted or is 
equal to 0, list the entire program. If "X" has been used, print only the lines themselves, 
if "X" has not been set, number the lines ("nnn >"). 

next buffer 

Form: N n ^ 

Output the current buffer to the output file, delete it from core, and then read in a new 
buffer from the input file. (See Read command and also the notes on Special Characters at 
the end of the tutorial.) 

(3) output 

Form: O n,m 
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Output to the output file, lines "n" thru "m". (No line numbers ore in the output.) If 

"m" Is omitted, only "n" is outputted. If "n" = 0, the entire buffer is outputted. (If "n" omitted 

it is assumed to be 0.) (See notes on control-C and Special Characters.) 


punch 

Form: P n,m ^ 

Same as "O", except punch on H/S punch 
QUIT 

Form: QUIT ^ 


Return to disk monitor. If a disk output file has been specified, then update all disk files 
and return to the monitor. If a|non-disk|output file has been specified, NO disk files will 
be written or destroyed; the disk will remain as it was before the editor was called. 

EXAMPLES: 


.EDIT ^ 

*OUT - S:TNUM ^ 

•k 

.EDIT ^ 

*OUT - R: 

* 

*IN- R: ^ 

*IN - S:TEST 

•k 

♦OPT - ^ 

•k 

*OPT - D 

A 

II 

LJJ 

m 

II 

V 

various commands 
issued here. 

various commands 
given. 

E = >QUIT ^ 

E = >QUIT0^ 




Note - all updates are 
performed. The file 
"TNUM" will have 
been created on disk. 



read from input file 


Form: R 


Note - Nothing will 
be changed on disk, 
REGARDLESS of the 
"D" option. 


Read from the input file until: 

The buffer exceeds 3/4 capacity. (No characters are lost -- the read terminates after 
the current line is read.) This allows room for work - (i.e. Append, Insert, Change, etc.). 
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© A control-L (214g) is encountered in the input string. The reod may be continued 
by issuing another "R" command. The same rules ( ©-•-© ) apply. 



search 


Form: S n String ^ 

Search, starting with line "n", for the next line containing "String". If "n" Is omitted 
assume ".+1". 


@ top 

© Form: T ^ 
Same as: L 1 >1^ 


© Form: T<^ String ^ 

Same as SI «) String ^ 

unset verification of Change Command 
Form: U (note - no " ^ " needed) 

Do not print the corrected line after a change of the form - 
£C n,m c) fetring gstring 

This is useful If a great many lines are to be changed - Example = 


C 1, 395$A$XYZ 123456 

where an "A" may occur in every line, 
verify the change 

Form: V (no " ^ " 

Opposite of "U" command. 

unset line numbering from Teletype 


Form: X (no " ^ " 
read the title, you nitwit. 

^ set line ^'s 

Form: ^ (no " ^ " 
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Q print current line ^ 

Form: ^ E=> . = nnn 
where "nnn " is the current line 
print last line ^ 

Form: same as " Q " 

Q) change current base to either Octal or Decimal 
Form: T 

where is the letter: for deciami ^'s or a for octal ^'s 

( I Ol is assumed if not a cm typed) 

EXAMPLE: 


.E = OCTAL ^ 
JE = . > r ,DECIMAL 


(a "3" was typed after the " 1“ ") 
(a "D" was typed after the " T ") 


NOTE - This affects only Command Strings and line ^'s - NOT the actual buffer, 
previous line 

Form: < (no " ") 

Same as L . -1 ^ 

Same as except L . +1 

Print current base . 

Form: E = >: base ^ 

where base is either: OCTAL or DECIMAL 
change the delimiter ("o)") 

Form: E = > $ < 

V. .J 

DELIMITER >. ( 1 ?) 

where (£) is a one-letter, (printing) character. It is advisable not to use (T) (+^ 

or the digits JE( —> 9. (obviously) 


















r 


e 


I 


0 (quote) 


repeat the prevrous command. 


Form: E = > " (no " ^ " 

See title. 


NOTE - will not work on "Change Command" occasionally because of internal structure 
of editor. 


This is useful in: 

EXAMPLE 
E = > S$ABC d 
® jZi03> A, ABCD3 
E = > " 

0fi7> AX, AY, AZ, ABC X 

E=‘> " 

095 > ABCDE>X 

.E = :> " 

? (no "ABC" found in buffer.) 

E = > ". 

? (no "ABC" found in buffer.) 

E= > 


PART FOUR - Special Characters and Options 
I. Control-C (203^) 

A. During printout of a Command. — Will return to Command Level. 


B. During a Punch, Output, Next, End — Will return to command level after the current 
line has been punched (outputted). The current line pointer (".") will be set to the next line 
in the buffer. 
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EXAMPLE 


E = > 0 7, .+9 ^ 

.=30 at this time 

1 ) 

(control-C typed 


(last line outputted was line 14 

E = > D 1, 14 4 

delete lines already punched 

E = > E 


? a 

T C (control-C typed) 

E = > D 1, .-1 ^ 

delete and continue 

m 

11 

V 

m 



Disk Monitor Level 


II. Control-L 

A. " T L" ore put at the end of each buffer or after O, P, N, E commands. A control-L 
is not put after a control-C half of the punch, etc. However, it will be put at the end of 
the buffer. 


B. Are used to halt the input (H, R) commands. This halt is done, rather than the buffer 
check (See READ command) if the buffer is less than 3/4 full. 


C. If disk files are used, the file is closed when two control-L's in succession are found. 
Two control-L's are placed at the close of an output file. 


That's all I can think of-- 


Please address any questions to: 


Bill Done Ison 
83 Wychewood Road 
Memphis, Tennessee 38117 


Thanx very much. 


Bill Done Ison 


f 
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